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. ABSTRACT 

Research on man-machine communication was 'examined .to gain insight into 
jtechniques fqr improving inter^dtive programs through, the enhancefnent of 
communicative style^t The human-computer interaction is compared to afl con-- 
versation, and specific recommendations for improving this interaction are 
enumerated. , The suggesbions are general in nature and a?:e arranged ir\^o 
a preldtiniriary "Guide to Style i'n Interactive Programming". *X sample inter- 
active program th^t tries to incorporate some of the recommendations cited 
is included as^an appendix. ' 



INTRODUCTION 



/ 



/ 

Few people who have interacted personally with a computer have lukewarm 



feelings about the experience. ^ Mo^st often, people find the interaction 
either ^highly enjoyable or totally distasteful (Martin, 1973; Melnyk, 1972) 
The strengths, of these reactioTis are an irftportant consideration in the Re- 
sign of compute^c-assisted instructional (CAI) programs, as students who 



find the interaction distasteful will be^^ reluctant to use the computer re-* 
peatedly. * 



It is this author's belief that most of the distasteful qualities of inter- 
active computer programs may be attributed directly to their poor communi- 
cative style. This is because program authors often fail to consider the 
posture of the naive user. This paper attempts to provide guidlines fqr 
good communicative style by examining the research on man-machine communi- 
cation and techniques ^that can be used to smooth the human-computer inter- 
face. ^ ^ , . , 



ERIC 



CO^^PUTER INTERACTION AS ^^CONVERSATION 

'J \ . ■'. - ) " 



Nickerson (196/9)/'suggests that little work .in the related fields of ergo- 
nomics/ , human^ factors, and human engineering' can be- applied dx^ctly ' to 
the design of effective human-computer inte;:actions/ "What raak^s the man- 
computer interaction qualita^vel^ different from ^her types of man-machine ^ 
interactions", he explains ,^"is the 'fact that (man^-computer interaction) ' 
may be descril^ed, without gross misuse of wo/dS/ as a conversation". This 
theory can* be supported by comparing* Schramm's model of communication (195.4), • 
shov/n in Figure 1, to a diagram of the processes involved in human-computer ' 
interactions, , shown in Figurev2. ' ^ 

/ ^ ^ , • ' • , 

From these diagrams, it might appear that the ideal human-computer inter- 
action v;ould be an exact replica of a l\uman-fiuman conversation.-^ Chapinis 
(1971) and Foley (1973) pbiRt out several- 'reasons, vfliy this ^s not yet tech- 
nologically possible r and even a..brief examination of this approach^will ^ 
show why it is not desirable in many applicatp.ons. For example, graphic 
display techniques can impart, far more .information^ th^n verbal channels ^ 
(Martin, 1973), and interactions wi^th computers can. improve upon normal 
technical conversations by reducing redundancy (Nifikerson, 1969). The. most 
desirable type of human-computer 'interaction , then, might be described as 
the on^ which allows the most efficient operation of t?he human-computer * 
system . 'That isr^^it should be designed to provide the easiest- to-use inter- 
face between the problem* ^efined'i^y the user and*the related capabilities, 
of ±he coipputer (Foley, 1973; 'Melnyk, 1972). ' ^ 

In our struggle .for efficiency, however, we o.ften sacrifice- the convenience 
of the user for th^ convenience of the system. Users are forceci to understand 
cryptic messages and respond -^with codes 3;ather t:han witji words*. Somehow,"^ 
we forget what it is like to be users the minute we become programmers, 
just as we forget what it is lik^.to be pedestrians when we become*drivers. 
Our programs then impart the character of a cold automaton rather than a 
human author. # • - ' , 

The recommendations presented in t*he remainder of this paper are 'intende'd 
to provide preliminary guidelines* for programmers who wish to rehumani^ze 
their programs but who have only* a minimum computer interface (standard 
teletypewriter or small cathode-ray tube) and knowledge of a high level 
language such as BASIC. They are interpretations (both inductive and deductive) 
of related literature and should not be construed as recoittmendatiti^is speci- 
fically int^Q^ed by the referenced- authors in tbeir original contexts*, 

A PRELIMINARY GUIDE TO STYLE IN l 

" INTERACTIVE PROGRAMMING ' " ^ 



'As yet, no acknowledged sense of style has developed for 
CAI... In the meantime, however^ some singularly unstylish 
CAT programs , are being written. (Martin, 1973, p. 413) 
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(I) - Maximize the ahount of ipteraction in your programs , : Meridith (1973) 
^ suggests that "machine surrogate tutors" best impart information through 
continuous interaction. Foley (1973^' points out that a program will have 
the best chance of understanding the user's desires if it can get the user 
to supply a "stream of input". Yntema (1969) has observed that as inter- 
actions becbme more "expensive" (both in th6 monetary 'sense and in the number 
allowed), computer users are far more anxious about making errors . Intern- 
action can be maximized by keeping your message^ short and requiring a user 
response after every few lines. 

Tie your programs in with other media . Sometimes, short messages do 
not p5:ovide enough latitude, to tell the user all that is necessary. But., 
rather than priVit /Dut several pages of text on the terminal, Heines (1975) 
suggeste that a user's guide be written to -accompany the program, 'fhe user's 
guide might include diagrams and 'photographs v^hich do not lend themselves 
to ^computer displ^ or just ciescriptions th^t. are easier to read from a . 
printed* ^age than from the computer germinal. . 

* c 

(3) Use upper and lower case if available . This recommendation has beeji 
made by Repko (1975), among others, and is consistent with her view tha't--^* 
a computer system should "cpnform to the user's conception of the environ-- 

*ment". As tex.t is normally preseated in upper and lower , case, so should 
it be on the computer terminal (if physically possible). Upper case text 
has a cold7 ^official feeling v;hile lower case text is less forbidding.'' ' 

(4) . Display program output along the entire width of your screen or paper . ^ 
Gregory and Poulton (1970) ^found that poor readers had signTficantly po^e^r 
reading comprehension when text, of seven words per line was right- justified 

as compared to their ability, to c'omprehend^he same material with uneven 
right-hand margins. (Good readetrs showed no significant difference^ in com- 
prehension' with the two methods of presentation.) ^THis effort was nullified, 
however,' when the text was lengthened to twelve words per line. The pri- 
mary implication of this finding is that text dt seven words per line or 
.less should not be right- justified. 'The. secondary implication is that text 
lUnes should beCin^de as long as possible, at least tip to twelve words per . 
rine\ Thus the width of the output device (screen or paper) should ^imit ^ 
the length of your message lines rather th^n the convenience of the program. 

• ./ V ' ^ \ ' r V ' ■ : 

For example, apnsider the normal i)se of the PRINT statement to produce pro- 
glram output in BASIC. If the length of a statement line is limited to the 
Vidth of the output* medium, program output must be at least eight characters, 
shorter than the width^fiDf the medium. This is because at least urie space 
is needed for the line number, five for the PRINT command, and two for the 
opening and closing quote's^ The problem can be easily solved by using a 
semicolon ^t, the end ^f a PMiNT statement and continuing the additional 
text with the next stafc'empnt line. 

(5) . I >!eep format and styl4 in mind . McLaughlrin (1966) coiopared the abilities 
of college undergraduates to locate information in well-produced and' poo^Jf^^ 
produc'ed (verbose) technical pamphlets. He found no significant difference 
in te'st performance when the two typps of pamphlets were used by motivated ^ 
students. Unmotivated student^p, however, showed significantly poorer per* ^- 

^fdrmance when they used the poorly produced pamphlet as compared to'th<'ir 
performance. wi^h the well^produced one. In both cases ' — motivated arul 



unmotivated — students spontaneously stated that* they would not have re^d , 
the poorer version voluntarily, McLaughlin concludes.- ' * 

Objective measurement may show that the st^^le of presenT ^ 
tation of printed technical matter has little effect upon 
the efficiency with which information can be culled from ^ 
J.t. Yet subjective preferences may be so strong as to 
make readers ignore material pr.esented in a certain ^tyle, 
•(Page 257) - " . • ^ 

(6) Consider the experience of your target population . Mi lis I (1^67) and 
Nickerson (1969) have stated that the population of computer us^ is be- 
coming increasingly heterogeneous. This means that more and more naive 
users are continually coming into contact with interactive computer progr&ns 
The style of these programs should therefore be frie^idly and conversational 

(Martin/ 1973). Repko (197^5) feels that ^programs written for naive users 
must not assume 'the programmer *s . knowledge of computer terms and operations. 
She acknowledges the' difficulty ^of "putting Yourself into your user's shoes" 
by 'describing the programmer as seeing the computer from the ."inside" while 
the user ^ees it from the "outside". 



Consider the act of entering data to a program in an interactive mode. 
In BASIC, the\>rogram statement used for this purpose, is INPUT, wliich prints 
a question marR on the terminal and accepts data tj^ped at the k^V^ard, 
Very often, th^re'fore, one sees interactive programs- which p^rint ou^queries 
like this : " ^ 



INPUT THE^ INTEREST^RATE IN % PER YEAR 



7. ^ 



This ^ery clearly reflectife tlTe programmer's view of the data eqtry proce- 
dure. The i^er must interpret the word* "input" as "type". With lit-tle ' 
additional effort,' the ■ programmer can use the question mark as normal punc- 
tuation and relate more closely to the user'ss^iew of the data er^try .proce- 
dure: f 'J, " . 

/ WHAT IS THE INTEREST RATE IN .% PER YEAR? 

< ^ ' . * ' 

This is a simple'; c[uest ion, and the fact that a user response in required 
is more obvious. v. , 

(7)* Prompt the user as to the type of response Required . Even the most 
obvious query to an interactive programmer may not immediately indicate 
to a naiVe user the type of respbhse to be made. When users are prompted, 
however, the doubt is quickly 'erased (Heines, 1974). For example, 

PLEASE TYPE "YES'^ OR "NO" IN RESPONSE TO THE FOLLOWING 
QUESTION AND THEN PRESS THE.'RE^RN KEY: * * ' ' 

HAVE YOU EVER USED- THIS TERMINAL BEFORE? 

Once this type^of instruction i^^^^n, shorter prompts usually sufficov ^ 

^ WOULD MOU "LIKE TO RUN THE PROGRAM AGAIN NOW ("YES" OR "NO")?- 



(8) Use^menus i:o indicate the us$r*s options ♦ Option menus have been * 
ui^ed successfully with all classes of computer users (Foley, 1973; Martin,^ 
1973). jThis technique allows the user to select an ogtion from a. given 
^ist quickly and efficiently because all available options are displayed 
and indication cff the option desired by thNg^ user is extremely simple. Fjjl- 
lowing i^. an example of a simple option menu v/hich. guides the student through^ 
an interactive environifient (Keines, 1974): , • ^ 

' ' ' ♦ ' 

*f0U ARE NOW REGISTERED FOR THIS TERMINAL SESSION AND « 
MAY SELEGf? A PROGRAM OPTION FROM THE FOLLOWING LIS^: 
'> ♦ , ' 

(1) . RUN A CHECK POINT PROGRAM * • . ^ ^ * ' 

(2) * DISPLAY ALL THE DATA STORED ON YOUR WORk'' 



(3) DISPLAY ALL STORED DATA IN SUMMARY FORM / 
OR... V , ^ /^K-v ' J. 

(4) - END THIS TERMINAL SESSION / - 



WHICH OPTION WOULD YOq LIKE TO EXECUTE NOW (TYPE A 
^ NUMBER)? ' * , ' 



(9) Make error messages friendly and factual^ Programmers very often over? 
look the importance of carefully constructed error messages. In the worse ^ 
case, their* error messages are flippant insij^ts to the user* At best, error 
messages are often omitted, queries answered indorrectly are simply reprunted, 
and .the user is surprised to see a question a^ked agairj that He ^Jis^^she has 
just answered. Consider the foiipwing^interaction: * \ 



Computer 



HAVE YOU EVER USED THIS TERMINAL ' BEFORE? 



User t YSE 

Computer: HAVE YOU EVER USED THIS TERMINAL BEFORE? " 

The naive user will surely be confused, thinking that ^he or she has already 
respoi}dec( "YES" to this query. ' . , ' ^ * 

One^ solution is to tell the user that an incorrect responsL h^ been^ade* 
When this is done, however, Meredith (1973) suggests ^that messages using 
Jberm^ such as "not understood" or "rephrase", should be used rather than 
"that most irritating word in the programmer's lexi'cont ILLEGAL!" 

Foley (1973) str^ses that i*to the'^ser, each error is a unique obstacle". 
The programmer must handle unanticipated responses "elegantly", 1.^' cof^tinues, 
encouraging the user to correct the error.- He notes: 

A reference librarian is very unlikely to tell a user 
that she has no idea what he is talking about — yet 
.this is exactly what computer infopnation systems ' 
regplarly^ do. Thus they quickly' gain »a reput^ation ^ 
. for being frustrating. * ^ . 



The following ^sca^^'e of error, handling improves upon the interciction shown 
previously: • ^ 



Computer 
User 

Compute!^ 



•HAVE YOU EVER USE5 THIS TERMINAL BEFORE? 
YSE " * 



I CAN ONLY RECOGNiZE THE RESPONSES "YES" 
OR "N0"« TO THIS QUESTION. PLEASE CHECK 
YOUR RESPONSE AND TRY AGAIN. 



^ HAVE YOU EVER USED THIS TERMINAL BEFORE? 

, This type of explanatory error message can be su^f/Lciently generalized to 
be programmed as a subroutine and cali^d whenever a "yes" or "no" response 
J.S required. . ^ • , 

(10) Do jaot eliminate message redundancy at the expense of message "clarity ^ 
Some read!e;rs may feel that the above messag^ is far too, wordy tb be ^^rac-^ 
tical, e^^cially if it is repeated each time this mistake is toade. But 
the balance of jpessage redundancy and clarify is often delicVt;e: too mucn 
redundancy' can bore an audience while too ^little can confuseJ^them (Schramm, 
1954). Nickerson (1969) admits that "all use^s tend to be impatient with '* 
redundant and non-informative messages", but further notes that: 

t \...the extent to which any particular communicationj ^ 

frcM the computer is redundant or non-iAformative ^ ^ ^ 
depends upon the amount of experience that the user 
has'-had)>.with izhe system. 

»'For example, the message: ' 

'f .. . • ' ■ ■ ' • 

.DA 90 J . ' I, * i 

■ . . ^ \ 

may be sufficient for some trsers but non~informa1:ive fo:^ others. The message 

^ : 

OUT OF DATA AT^LINe' 90 * , ' t 

yields more .information, but may be rtsdundant for^ experienced users. 

A solution suggested by Nickerson (1969) is, to use shorter- abbreviations 
and mnemonics, but to allow t;h*e user to viBw* the longer, less cryptic message 
by entering, for example, ^'what" or '*?". "^e should also consider tfie dis- 
play rate of the user*s terminal when planning error messages, as longer 
messages are ^to/erable when they are displayed quickly but intolerable if 
they are displayed slowiy.' \ 

(11) Give the user as mqch feedback as possible , Foley (1973) and Schramm 
(1954) have pointed out ^he importance of feedback for the successful opera- 

*tion o€ any communication system. Melnyk (1972) and Meredith (1973)^have 
a?elated the use of feedback to interactiye computer programs in the form ( 
of error messages for incorrect input. But feedback can also keep the user 
informed of the state of the system. For* example, naive users are often 
cgiifused when the terminal pauses if Input is not required, as may be the 
case while a tape or disk file is being processed. Confusion can be avoided 
by printing, for example: 

YOUR SCORE. IS NOW BEING RECORDED... ' 
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or, more simply: 

/ , . , . » 

ONE MOMENT, PLEASE/, i*. 

; / ■ > • . ' ] 

(12) Use graphics wherever/ possible , Graphics need not be limited to j 
expensive, sophisticated s^fetems. Even simple diagrams can be very helpful ^ 
in trying to communicate i;^eas. While teletypewriters are extremely slow ^ 
fo^ displaying graphics^^ 3nall cathode-ray tubes (CRT's) usually have special , 
functions such as tab, b^^kspace^ and screen clear which can b3 us^ed tb ^ 
speed up the rate at which graphics can be displayed. Th^e features mak6 ] 

it feasible to draw graphs ^nd diagrams 'at a reasonable rate within the I 
'limitations of the terminal's character set. ^ | 

(13) Write your programs so -that they can be changed, improved, and enhanced . . 
As interactive programs are used, their strengths and weaknesses become ^ 
apparent. If programmed in^ a .haphazard manner, their weaknesses can b^ ^ 
very »dif f4.cult to correct, even if they involve only a small change in wordin^^ 
and structure. Repko (1975) suggests that programs be made flexible by 
functional division, isolating the input and output sections (see Figure . . 

•3). She^^comments: ^ - y 7 ' i . 

The mechanism of the program , should n'e^r be an excuse 
•for ' not allowing chang^s in the man-^itiachine conpufiicationj. 



The simplest way tj;o make programs adaptable is to dopument them extensively., 
The readet is referred to the program listing in the appendix as an ^example , 
of a BASIC language program thaHi was extensively documented by using the 



REMARK statement • 



h ■ ■ ■ 

(14) Never ^ive an to the machine * Anyone who has asked a busy programmer 
for assistance on a programming problem has heard the reply, "It can't be 
done". Usually, this sim|)ly means- that the problem appears to be non-trivial 
and the programmer does not wish' to take the time to help you.* .Time and 
again, however, computer people have proven that there is some truth in 
l^he saying, "the impossible we do immediately; mixacles take a little longer". 
No matter how impossible your idea might seem at first, yoli oan usually 
implement it in some form even* if you have to compromise slightly. Careful 
scrutiny of your system will almost always reveal ways to get around limi- 
tations imposed by the hardware and software. 



CONCLUSION 



The guidelines presented in this paper are not novel. 'When viewed in retro- ^ 
-^spect, most of the recommendations appear to be the product of plain common 
sense.. It is encouraging to note, however, that actual research does i^upport 
,th^se simple ideas. It is this author's hope that further research will 
expand this effort and that interactive programs written with a clear com- 
municative style will m^ke it easier for people from all backgrcSunds to 
use the computer effectively and enjoyably. ' ^ / , 
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* /' ' APPEm)IX: PROGRAM EXAMPLE ' , ^ ' ^ 

A total of fourteen recommendations 'for the enhancemeQt of interactive . 
' program' style were given ^ in J:his paper^ These guidelines were used by the 
authoi? to modify. and expand a* program originally writte^n by Bob' Albrecht 
(P^eople's' Computer Company, Menlo Park, California). This^, program, origin- 
ally called "hURKLE, was design to give students practice in working with 
the' Cai?resi^n coordinate system in a game format, ^ t; I . 

A .sample run of the mpdified^^program, called HURKJ32, appears on the following 
two pagesi This 'lyrint-out was photocopied directly, from a ^computer terminal, 

^ but the ifiput» Supplied by the' user has-been underMnied fo^ clarity. The ' \^ 
numbers' t;^ped in the ^right-hand ttiargin^ correspond to the numbers of the ^ 
specific recanmendations in the Jbody of » this paper that were considered 
i:fhen that part of the program was designee!. * A listing of the BASIC language 

^ statements that- make up this program (in OS/8 BASIC) appears on the four, 
pagjes following the i>rogram print-out ^ ' ^ 



V ^ 



^ * 'J. 



HURKLE TWO 
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Da vou wi 



JO 



SEE THE INSTRUCTIONS <«VE£" OR ''NO"V"?VES ^ 



/ 



fl HURKL'E rsjUJ>im fl CARTES I AN COORD I MATE GRID 
LIKE THE ONE AT THE RIGHT. GUESS ITS LOCATION BV 
ENTERING A HORIZONTAL COORDINATE^ FOLLOWED BV Vl 
VERTICAL ONE. FQR EXAMPLE. THE <IS FIT -4. i . , 
POINT 'DaO, is at the CENTER OF THf^GRID. WHERE 
THE + IS. AFTER Eftt^H GUESS/ I WILL TELL VOU 
WHERE TO GO TO FIND THE HURKLE BV SAVING "NORTH** 
FOR THE POSITIVE VERTICAL DIRECTION. -WEST" FOR 
THE NEGATIVE HORIZONTftL. ETC. GOOD LUCK! 



/ <POS> 

F W <7-t.— > E 
<NEG) ^ ! ■ <POS> 

S .• 

" <NEG>' • 



VOUR AVAILABLE OPTIONS ARE NOW "GO'S •*riELP% "INSTR". "QUIT". "SIZE'S 
AND "TRIES". WH;CH WOULD VOU LIKE TO ^XERCISE RENTER A >^j^ORD> ^;G0 i 

HURKLE IS HIDING' IN A lO BV 6 COORDINATE GRID. H0RIZ0r4^AL> 
VALUES GO FROM -5 TO 5 AND VERTICAL VALUES GO FROM -5: TO 2 } FIND 
THE HURKLE WITHIN 6 GUESSES!; ^'\x 



( 1) 

*( 2) ^ 
( 5) \ 
112) 



"(8) 



( 6) 



VOUR FIRST GUESS CENTER COORDINATES SEPFlRAT^D BV Fl COflMA) ^'0.0 (7) 
GO SOUTHWEST... . / » - . 

VOUR SECOND GUESS ? -4. -M , /, * 

VOUR SECOND CODRcilNATE' IS OUTSIDE OF •THE HURKLE-'S GRID. TRV AGAIn\ . . ^ ( 9J 

VOUR .SECOfJD GUESS ?-4. ' " 

GO SOUTHEAST. . . ^ . . . . ^' 

VOUR THIRD GUESS ? -2. -2 ' • 

GO EAST. . . 

VOUR FOURTH GUESS r :< ^ ~ 

HURK! HURKf' VOU FOUND THE HURKLE IN 4 GUESs'eS! ! 

IF VOU'^D LIKE TO PLftV- AGAIN. PLEASE ENTER THE "GO" OPTION feELOW^ 

■ / • ■ ' ■ 

VOUR AVAILABLE OPTIONS )=lRE NOW "GO". "HELP". "INSTR". "OUIT". "'-.IZE". 

AND* "TRIES". /WHICH WOULD VOU'lIKE TO EXERCISE CENTER ft WORD) ?HELP { 7) 



VOUR OPTIONS/ PERFORM THE FOLLOWING FUNCTIONS: 

60 / LOCATE THE HURKLE AT A NEW GRID POINT AND ALLOW VOU TO 

GUESS WHERE IT IS HIDING 
HELP DISPLAV THIS MESSAGE 
INSTR DISPLAV THE INSTRUpTIONS 
QUIT END THE GAME 

SIZE CHANGE THE SIZE OF THE GRID IN WHICH THE HURKLE CAN HIDE 
.TRIES CHANGE THE NUMBER OF TRIES ALLOWED Yo FIND THE HURKLE 
TO* MAKE THE COMPUTER EXERCISE AN OPTION. SIMPLV tVPE ITS KEVWORD BELOW. , 

VOUR AVAILABLE OPTIONS ARE NOW "GO". "HELP". "INSTR". "QUIT". "SIZE". 
AND "TRIES". WHICH WOULD VOU LIKE TO EXERCISE (ENTER A WQRD) ?S1ZE / 



(B) 



(10) 



ERiC 



14 



^ . / 13 



THE CURRENT SIZ^ OF THE HUWLE'-S GRID IS ICi EV € (HCfRlZONTflL BV 

VERTICftLX VOUR NEW DiriENSIONS MUST flLSO BE EVEN INTEGERS. - ENTER VOUR 

NEW DIMENSIONS EELON SEPARftTED BV A XOriMfi.. HORIZONTflL DIMEf^SlON FOLLOWED ( 4) 

BV VERTICAL. VOU MAV LEAVE THE GRID SIZE UNCHANGED BV ENTERING "0/0". 



VOURx NEW D I PENSIONS ?2a. . 20 



J. 



VOUR SECOND DIMENSION IS NOiT AN EVEN INTEGER. PLEASE TRV AGAIN. . ( 9) 

• VOUR NEl4^DiriENSI0NS ?20. 20 * ^ ' ' 

THE NEW SIZE OF THE HURKtE'-S QRID IS 20 BV* SO . - ^(11) 

Tr' ' . ' 

VOUR AVAILABLE OPHONS ARE NOW "GO". "HELP". "INSTR". "QUIT". "SlZf^S 
'AND "TRIES". WHICH WOULD VX'U LIKE TO EXERCISE <ENTER A WORD) ? TRIES 

, VOU ARE NOW ALLOWEp t. JRIES TO FIND THE HURKLE. ENTER VOUR NEW LHIIT 
BELOW. VOU MflV LEAVE THE LltlLT UNCHANGED BV ENTERING "0". ' 

VOUR NEW LirTlT ?^ ' - \ / 

: VOU WILL NOW BE ALLOWED 4 TRIES TO FIND THE* HURKLE. / (11) 

VOUR AVAILABLE .OPTIONS ARE NOW "GO". "HELP".. "INSTJ<".. "ClUIT". "SIZE".. 
AND "TRIES". WHICH WOULD VOU LifKE TO EXE^RCJ-SE <Er^TER A WORD) ?G0^ 

'■ . y . , ' ^ . 

T-HE HURKLE IS HIDING IN A 20 BV 20 COORDINATE GRID. HORIZONTAL 

VALUES GO FROM -10 TO 10 AND VERTICAL VALUES GO FROM ~iO TO 10 . FIND 

THE HURKLE WITHIN 4 GUESSES f . * ' ' ^ . 

< 

VOUR FIRST GUESS <e'nT'ER COORDINATES SEPARATED BV A COriNA) ?0.. 0 ' > * 

. GO SOUTH. . ' ^ 

VOUR SECOND GUESS ?0. -5 "* ' -^-^ 1 _ ^ 

GO SOUTH..: . ' . ~ nr — 

VOUR THIRD GUESS ?0. -7 ^ 

60;:S0UTH. . . ' 

VOUR FOURTH GUESS ?0. ' ^ * . ^ 

SORRV. BUT YOU HAVE HAD THE* LIMIT OF 4 GUESSES. THE HURKLE WAS HIDING 
AT POINT 0. -10 . * . - 

T ' • 

IF VOU'^D LIKE TO PLAV AGAIN. PLEASE ENTE^' THE "GO" OPTION BELOW. (10) 

VOUR AVAILABLE OPTIONS ARE NOW "GO". "HELP". "INSTR". "CiUIT". "SIZE". 
AND "TRJES-\ WHICH WOULD VOU LIKE TO EXERCISE (EmER A WOF'D) ?C!UIT 

I . ' t '^^^ 

VOU PLAVED. A TOTAL OF 2 GAMES AND FOUND T/HE HURKLE 1 OF THEM. * (11) 
THAT'-S A WINNING PERCENTAGE OF 50 ?i ! ' 

BVE! . * • . . ' • 



I 



LIST 



5. 0 



1000 
1010 
1029" 
1030 
1040 
1050 
'f060 
10?0 
10$0 
1030 
1100 
lliO 
,1120 
1130 
1140 
1150' 
11^0 
1170 
1180 
1190 
1200 
1210 
1220 
12S0 
12^6 
ir250 
12&0 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1350 
1370 

i3eo 

13S0 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1519 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1»>00. 
1610^ 
1620 
1630 
1640 
1650 
1660 
•1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 

ireo 

1790 
ISOO 
1?10 
1^20 

laxo 
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* H LI R K L E TWO/ * 



"HURKLC- nUTHOR. 



BOB ftUERECT 

PEOPLE'-? COMPUTER COHPFlNV 
MENLO PARK* CftLIFORKIft 

-lOi BfiSlC GftMES- 
D I G I TFllf^QUI PMENT CORPORflT I ON 

JES-.SE M. H£INfe;r. 
PIGITftL EQUIPMENT CORPORATION 

JfiNUfiRV, IS'rS 



4 If 4c «c 4. 4f 4. 



VARIABLE 



VARIABLE 
USAGE 



D I R E C T 0 R V 

\ 



R£(l • • 
REI1. 
REM ^ 
REM 
REH 
REM 
RElf 
RfH 

REM 0RIG1NRL 
REM 
REH 
REM 

REM ORGJNALLV PUBLISHED IN 
REM 
REM 

REM ADAPTED FOR CLASSIC EV 
REM 
REM 
REM 
REM^ 
REM 
REM 
REM 
REM 
REH 
REM 
REM 
REM 
REH > 
REM 
REM 
REM 
REH 
REM 
REH 
REH 
REM 
RElC 
REM 
REM 
REM 
REM 
REM. 
REM 
REM 
REM 
REM 
REH 
REM 
REM 
REH 

LET C0i»CHR*<34> 

LET Ci^^CO* A % e CO^ 

DIM TJ<10#8> ' 

REM FOR OECSVSTEM 10, REPLACE ABOVE STATEMENT WITH. 

REif ^ . Din Tr<io> 

TH^RD•'* 
-EIGHTH" 



A 

fit 

COiT 

Cll^ 

01 

02 

G3 

G4 

H 

U 

12 

13 

K 

N 

Nr 
PO 
T 

Tf<K)* 

V 

l< 



INPUT CODE 0«"N0-# j^-VES"' 
GENERAL ALPHAMERIC USER INPUT 
CHR/<I4> £ ' 3 
CO/ t V,^ cot C^* -3 , 
HORirONTAL GRID DIMENSION 
VERTICAL GRID DIMENSION 

L»SER-*f:EDUESTED HORIZONTAL GRID DIMENSION 
USER-PEC'UESTED VERTICAL GRID DIMENSION 
USER INPUT* HORIZONTAL GUESS 
TOTAL NUMBER OF GAMES PLACED 

NUHPgP OF GAMES 'IN WHICH THE HUPf L£ HAS FOUND 
NUMBER OF GUESSES IN GAMES COUNTED IN -12- 
GENERflL FOP-NEXT LOOP INDEX . * - 

numeep of tries allowed per hiding place 
useptreduested number of tries per hiding place 

NUMERIC ARGUMENT PASSED TO A SUBROUTINE 
GUESS COUNTER 

ORDINAL EXPRESSION OF GUESS NUMBER- 
USER 'INPUn Vg^!TICAL GUESS 1^ 
HORIZONTAL COORDINATE OF HURKLE'S HIDING PLACE 
VERTICAL COORDINATE OF HURk'LE.' S Til DING PLACE 



if If 4r 4c 4> 4c 4i 



DECLAR. ATIONS 



"SECOND-* ' 
SEVENTH-* 



DATA -FIRST"* 
DATA "SIXTH"** 
FOjP K^X TO iO 
FEAD^ J$<K> 
NEXT K . • 

LKT n«o 
LET I^»0 
REM ' 
REM 
REM 

REH « ^ 4* ^ « 4< 
REH 
REM 
REM 

COSUB 3S20 

PRINT -HUR^^LE TWO** ' 
PRINT 
PRINT 
PR UK 
PRINT 
PRINT 
RANDOMirE 
LET Gl^fe:*2:* INT<4»R<iD^0^> 
LET G2"o*I-MNT<4*PND<0>> 
LET N = rw n4T<:J#RNDU«>> 
GOSME 3^70 

IF flao THEN irro 

GOSUB -iiTO 



-FOURTH"* "FIFTIi- 
f -NINTH-, -TENTH" 



MAIN 



.P R 0 /g R tA M 



♦•DO VOU WISH TP SE 

" OR -* cofi *'m-i 



I 



SEE THE INSTRUCTIONS 
CO** , 



-VES% CO** 
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1340 REM 

1850 REM ♦4#^*4.44 OPTION I H^P- i) T 
I80O REM « 0 r ' - . 

1870 PRINT r, 

1880 PRINT -VOUR flVfllLflBLE OPTION; 6RE N0« - * 

•1830 P0«1 
.IWO rfoSUB AOCO 
1510 F»INT "WHICH MOULD VOU LIKE TO EXERCISE (ENTER ft MORD>-/ 
1320, (input flf ^ 
1$30 PRINT 

19«J0 IF flla-GO" THEN 20?b 
1950 IF flIa-HELP" THEN 29^0 

1960 If flI'-INSTR* THEN 1630 t 
19?0 IF fllr-OuiT- THEN 4540 
»1980 IF. fl^s-SISE" THEN 3i40 
1,990 IF fll«-TftIES- THEN 35?0 
2t)00 PRINT -PLEfix-E. ENTER ONLV *; 
2010 P0«2 ^ 
2020 GOSU& 40tO 

2030 PRINT CO^, -HELP"; CO#i - PRINTS AN EXPLANATION OF EACH. > 

2010 PRINT "VOUR CHOICE"; ' 
2050 GOTO 1920 

2060 REif * * * - , 

20ro REM ♦♦♦11444 THE "CO" OPTION 
2080 REM 

2090 REM . 

2100 REM SET THE HURKLE'S CCOROINATES 

2110 REM • ^1 

2120 'Xa-Gi/2+ INT <<G141>*RND<0>> 

2130 V=-G2/2+INT<<C2+1>VrND<0>> 

2140 PRINT C2Si 

2150 GOSUB 3.^20 

^160 PRINT -THE HURKLE IS HlflNG IN A";' 

21?0 IF SEG*<STR^<Gl>,LEN<STR*<Gl>>,LENCSTPI^<Gi>>><>-S- THEN 2210 
2180 REM — FOR DECSVSTEH-ltf, REPLACE ABOVE STATEMENT WITH 
2190 REM IF RIGHT*<STR»<G1>. LEN<STRJ^<Gi>>><>"8' THEN 2210 

2200 PRINT -H-; ^ * 
^210 PRINT Gl; "EV-; G2, "COORDINATE CRIO. HORIZONTAL- 
?220 PRINT'-VALUES GO FROM % Gl/-2i -^0-; Gl/2; "ANO VERTICAL -j 
2230 PRINT -VALUES GO FROM S 02/-2; "TO-; G2/2J ". FIND" 
2240 PRINT -THE HURKLE WITHIN"; N; "GUESSES!* 
2250 PRINT 

2260 REM . ' . ' 

2270 REM ♦♦IT**** INPUT THE GUESSES " * 

2280 REM 

2290 FOR T»l TO N * . 

2300 PRINT « ' . « 

2310* IF T>10 THEN 2340 j " 
2320 PRINT "VOUR "; T*<T>; 
2330 'GOTO 2350 

2340 PRINT -VOUR**f T; "TH-; - » 

2358 PRINT - GUESST; 
2360 IF T>1 THEN 23S0 

237C PRINT ' CENTER COORDINATES' SEPARATED SV A COMMA)"; 
2380 INPUT H, V " ^ 

2390 REM 0 * 

2400 REM **CHECK GUESSES FOR VALIDITV 

2410 REM 

2420 IF H<-G1/.'2:THEN 2470 

2430 IF H>4Gl/2 JHEN 2470 * * 

2440* IF V<-G2/2 THEN 24?0 
2450, IF V>*G2/2 THEN 2490 
2460 GOTO 2550 
2470 PRINT " 'VOUR FIRST"; 
2480 GOTO 2500 
24 90 PRINT - VOUR SECOND" 
2500 PRINT - COORDINATE IS OUTSIDE OF* THE hOrKLE'S GRID! TRV AGAIN 
25iO« GOTO 2300 
2520 REM n> 

2530 REM EVALUATE A VALID GUESS 

2540 REM 

2550 IF ABS<X-H>+ABS<V-V>«0 THEN 2720 
2560 IF N»T THEN 2$20 
2570 GOSUB 4380 
2580' NEXT T 
2590 REM 

2600 REM ♦♦♦♦♦♦♦ OUT OF GUESSES 
2610 REM 
2620 PRINT 
2630 PRINT 

2640 PRINT -SORRV, BUT VOU HAVE HAD THE LIMIT OF"; NJ "OUES<^ES. THE 
2650 PRINT -HURKLE MAS' HIDINQ- 

2660 PRINT -AT P02NT/ rj, STRKX); "; STR*<V>; " 
2670 P0«0 J 
2680 GOTO 2810 
2690 REM 

2700 REM ♦♦♦♦♦♦♦ FOUND HURKLE MESSAGE ' 
2710 REM 
2720 PRINT 

2730 IF T>5 THEN 2790 

274p FOR K«l to o-T 

i750 PRINT -HURK' PNT<?>i 

2;60 REM — FOR t-EC SVSTEM-IO, REPLACE ABOVE STATEMENT MITH; 
2770 REM " PRINT -HURK! "; CHR^C7>; 

2788 NEXT K . * 
I 
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PRINT "VOU^OUfiO THE HURKLE IH\ Ti "GUESSES! ' 
2800 P0»1 
;>8J10 PRINT 

2320 PRINT -IF'VOU'D LIKE TO PLftV AGAIN, PLEASE ENTER THE "i CO*/ -CO 
2830 PRINT COI, • OPTION BEL CM. * 

PRINT * ^ 

2850 RE(1' 

2860 REM ♦♦#♦#♦4' INCREMENT THE GAME ANO TOTAL GUESSES COUNTE^ 
2870 REM 

2880 LET Ii»Il*l 
2890 LET la^I^PO 
2900 IF P0«0 THEN 1870 
2910 .L,ET I3«I3+T 
2920 GOTO i'870 
2.930 REM ^ 

2940 REM THE 'HELP* OPTION 

2950 REM ^ , • * 

2960 GOSUB 3tZ0 

2970 PRINT "yoUR OPTIONS PERFORM THE FOLLOWING FUNCTIONS; - 

2980 PRINT GO LOCATE THE HURKLE AT A NEW GRID POINT AND 

2990 PRINT '•ALLON VOU TO" 

3000 PRINT " GUESS HHERE .IT I? HIDING" 

3iU0 PRINT " HELP DISPLAV THIS MESSAGE" ^ 
30^0 PRINT " INSTR DISPLAV THE INSTRUCTIONS'* 
3030 PRIi^T " OUIT END THE GAME" - 

3040 PRINI - SIZE CHANGE THE SIZE OF THE GRID IN HHICH THE -> 
3050 PRINT "HURKLE CAN HIDE"- 

3060 " TRIES CHANGE THE^ NUMBER* OF TRIES ALLO^fED TO FIND "j 

3070 PRIUI -THE HURKLE" 

3085 PRInT "TO MAKE THE COMPUTER EXERCISC AN OPTION, SIMPLV tVPE "; 
3090 PRINT "ITS KEYWORD BELOW." 
3100 GOTO 1870 

3110 REM « ' ' f 

3120 RE41 • 'THE "SIZE" OPTION 

3130 REM 

3140 GOSUB 3SeO <• 
3450 PRINT "THE CURRENT SIZE OF THE HURKLE' S GRID IS"; Gl; "BV"/ 02/ 
3160'-PRINT "(HORIZONTAL BV" 

3170'PRINT "VERTICAL). VOMR NEif DIMENSIONS flUST ALSO EE EVEN "l 
3180 PRINT "INTEGERS ENTER- VOUR" 

3190 PRINT "NEW DIMENSIONS &ELOW SEPARATED BV A COMMA, HORIZONTAL 't 
3200 PRINT "DIMENSION FOLLOWED* 

3210 PRINT •*eV VERTICAL. VOU MAV LEAVE THE GRID SIZE UNCHANGED fcV "/ 
3220 PRINT "ENTEFrtNG"";. CO*; "O^p"/ CO*; ". " - 
3230 PRINT 

3240 PRINT "YOUR NEW DIMENSIONS"; 

3:?50 INPUT G7, G4 

3260 IF G3O0 JHEN 3280 

3270 IF 04«0 TTiEN :?410 ^ 

3280 IF* G3/20lNT(G3/2> THEN ^490 

3290 IF Q4/2<>INT<a4/2> THEN»^fll0 

3300 REM 

3310 REM VALID INJ^'UT 

3320 REM 

3330 LET Gl<fG? 

3340 LET G2»G4 

3350 PRINT 

3360, PRINT "THE NEW SIZE. OF THE HURKLE'S GRID IS"/ Gl/ "BV"/ 02/ " 
3370 GOTO 3440 
3380 REM 

3390 REM 0.0 INPUT * 

3400 REM 
3410 PRINT 

3420 PRINT "THE HURKLE'S GRID WILL REMAIN ITS CURRENT SIZE OF"/ 01/ 

3430 PRINT "BY"l 02/ ". " 

3440 PRINT , 

3450 coTonsro 

3460 REM 

3470 REM NON-INTEGER INPUT 

3480 REM 

3490 PRINT " VOUR FIRST"/ 

3500 GOTO 3520 

3510 PRINT " VOUR SECOND", 

3520 PRINT " DIMENSION IS NOT AN EVEN INTEGER! ^PLEASE TRV AGAIN. ; . " 
3530 GOTO ^23<} 
3540 REM 

3550 REM THE "TRIES" OPTION 

3560 REM 

3570 GOSUB 3820 ^ 

3580 PRINT "YOU ARE NOW Al^LOWED"/ N/ "TRIES TO FIND THE HURKLE. "i' 
3590 PRINT "ENTE5 VOUR NEW" 

3600 PRINT "LIMIT BELOW. VOU MAY LEAVE ♦THE LIMIT UNCHANGED BV "i 

3610 PRINT "ENfERINO "/ CO*l "0"/ CO*i ", " 

3620 PRINT ^ 

3630 PRINT "VOUR NEW LlMlT*/ 

3640 INPUT Nl 

3650 PRINT 

3660 IF HlOO THEN 3€?0 | 

3670 PRINT "THE NUMBER OF T^IES ALLOWED WILL REMAIN AT"/ N/ ". " 
3680 GOTO SriO y 
3690 LET U*Ui 

3700 PRINT "VOU WILL NOW BE ALLOWEf^'i Hi "TRIES TO FIND THE HURKLE." 
3710 PRINT 
3720 GOTO 1870 

3730 REM ^ ^ 
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S U £? P ' 0 U T I N E S 



•1 



ERIC 



3?50 PEW 

3?60 ♦ ♦ ♦ 4 4 <. 

37?0 REM ^ / 
3280 REJ1 
3790 PEI1 

380CU1k-CM ^'♦■i^^^^^r ' 
3810 REI1 r ^ 
3820 PRJNT \ PRINT 
3830 RFJURN 
3840 REM* 
3850 RF.H #«4t«44A 
38^0 REM 
3870 IMPUT fli 
3880 PRINT " 
3890 IF PC»S<fl», -V-, i>0Ci THEN 3?$0 

Hit Re!1"^ '^'^ ^^'''^^^ ^'^'^''^ STATEMENT WITH: 

ill^ ,1 INSTRCl, fi^, «V>0© THEN S^S-e 

.3920 IF P0S<n/>--N-/l>O-0 THEN 4010 

i^^R^M ''''' ?F'n;iJ^?:'S; J^S'L^'CE.ftf^^'VE STATEMENT WITH:. 
^.-f-^tjTKEM IF iNSTRd, Ar, -N"><>0 THEN 401© 

3950 IF RJ=-QUIT- THEN 4540 
:<9(;0 PRJMT - PLEASr INPUT 

3970 PRINT COti "OUIT"; CO^; 
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SCREEN CLEARER 



"VES", •NO%/.AND -QUIT' 



RESPONSE DECODER V 



COf; -VES"; CI*; 
VOUft CHOICE-/ 



"NO^i cd>; 



OR 



OPTION 



4070 PRINT "SIZEV 

0«2«THEN 4120 



GO"i Cl*i 

cost 



-HELP-/ ClTi -IMSTR-; Cl^/ 



P R 



?0OIT" 



"AND " 
"/*0R 



COf; 



CO*/ 



"TRIES-; 

-tr*ieS- 



CO$i 
I 'CO*/ 



"/ 



" 3980 GOTO 5370 
3990 LET n^X 

,* ' 4000 Return 

4010LET rt«0 
4020 RETURN 
4030 RE{\ 
* 4040 RErt * . 

4050 REM 
,*540^0 PRINT COI 
^ 4070 

4080 ir^po 

4090 PRINT 
4100 PRINT 
4110 RETURN 
* 4120 PR/nT 
4130 RETURN 
4140 REM 
4150 REH 4 ♦ 
. 4160 REM 
W 4170 GOSUI^ 3820 

4180 PRINT ;A HUPKJLE IS HIDING 'IN A CARTESIAN COORDINATE GRID- 
^LlkE THE ONE^ftT^THE RIGHT. GUESS ITS^LOCATION BV-/ 

"ENTERING ft HORIZONTAL COORDINATE FOLLOUED BV A -/ 

N" " . » 

^VERTICAL ONE. FOR EXAMPLE, THE * IS AT -4,1 . -/ 



/ Cl$v 



INSTRUCTIONS 



4190 PRIMT 
4200 PRINT 
4210 PRINT 
4220 PRINT 
4230 PRINT 
4240 PRINT 
*^250 PRINT "POINT 
4260 PRINT - 
4270 PRINT -THE i 
4280 PRINT 



0,0 IS AT. THE CENTER OF THE GRID, 
M E- 

IS. AFTER EACH GUESS, I MILL TELL 
CNEG> ! (POS> 



WHERE 



VOU 



•/ 



aIH '''''^^^ ^^^^^^ ^-^ saving -/ co*/ -north-/ 

4S10 PRINT ;F0R THE POSITIVE VERTICAL DIRECTION, -/ c6fs "WE^TV 

FOR (NEG)" " * ^ 
"THE NEGATIVE HORIZONTAL, ETC. 

\ 



GOOD 



D I R E C T I 




H I N T £ R 



4320 ^RINT - Pric. — '^[^'jtV^^ fiKtuiiON, -/ cO*/ "WEST*/ CO*/ 
4330 PRINT 
4340 RETURN 
4350 REM ^ 
4360 REM 41 ♦ 41 41 « 
4370 REM ^ 
4380 PRINT -Oti **; 
«i:J90 IF VaV THEN 4440 
4400 1F,V>V THEN 4430 
4410 PRINT '•NORTH"/ 
*«4;t0 GOTO 4440 
4430 PRINT -SOUTHV 
4440 IF H«X THEN 44$0 
4450 IF H>X THEN 4480 
. 4460 PR^NT "enST*; 
4476 GOTO 44?0 
4480 PRINT -WEST-/ 
4490 P^'INT 

4500 RETURN \ 
4510 REM 

4520 REM ♦ 41 4 41 
.453a REil 
4 540 PRINT / 

4550 IF 1K2 THEN ^ 

«lo PrIh" " PERCENTAGE OF-/ 100*12,11. >' ' 

"4600 ,IF I2<2 THEN 4650 , 

4610 PRIMT ;'^\I|'E:;.^^|;^^;G«^ES VbU HCH, iT TOOK VOU m nVERflOE OF", 
-FIND THE HURKLE. - 



Q t» 1 T T 1 N 



ROUT! N>E M. 



4620 PRKiT 
4630 PRINT 
4640 .PRINT 
4650 pf INT 
4660 PRINT 
4670 END 

REftOV 



"BVE! ' 



V 
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